home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / utilitys / 457 / ck_demo2 / ck_demo.txt < prev   
Text File  |  1990-10-05  |  11KB  |  235 lines
  1.  
  2.                             CodeKeys!
  3.  
  4.                       By Charles F. Johnson
  5.  
  6.                      ***   DEMO VERSION   ***
  7.  
  8.                  Copyright 1990 CodeHead Software
  9.                        All Rights Reserved.
  10.  
  11.               Demo Documentation by Charles F. Johnson
  12.                 Revised: Friday, September 21, 1990
  13.  
  14.              ******************************************
  15.              *                                        *
  16.              * This demo program and the accompanying *
  17.              * text file may be freely distributed as *
  18.              * long as both files are included, and   *
  19.              * neither file is modified in any way    *
  20.              * whatsoever.                            *
  21.              *                                        *
  22.              ******************************************
  23.  
  24.  
  25.   CodeKeys is the MACRO TOOL!  With CodeKeys, you can automate any task
  26. on your Atari computer.  CodeKeys records all key and mouse button
  27. presses, and plays them back with precise timing, or as fast as possible.
  28. Macros can be recorded and played back from within any program (GEM or
  29. non-GEM), and fine-tuned with a flexible word-processor-like macro
  30. editing desk accessory. 
  31.  
  32.   Here's a short list of CodeKeys features:
  33.  
  34.   o Record or play back macros at _any_ time, no matter where you are,
  35.     in or out of any application, GEM or TOS.
  36.  
  37.   o Macros can be recorded in real time for realistic playback with exact
  38.     timings. 
  39.  
  40.   o Any combination of keypresses may be used as the "trigger" key to
  41.     start a macro's playback.
  42.  
  43.   o Any combination of keypresses and mouse button presses, along with
  44.     mouse positions and timings, can be included in your macros.
  45.  
  46.   o Macros can be later edited to tighten timings and make them really fly. 
  47.  
  48.   o Full macro editing features include copy, cut, paste, replace,
  49.     delete, and append. 
  50.  
  51.   o The CodeKeys accessory has keyboard commands for all functions.
  52.  
  53.   o Up to 32 macros can be defined with up to 128 events each.
  54.  
  55.   o Macro definition files can be loaded and saved.
  56.  
  57.   o Macros can call other macros for incredible power and flexibility.
  58.  
  59.   o Repeating and delayed macros allow automated tasks such as periodic
  60.     saving of data files within applications.
  61.  
  62.   o Macros can be played automatically upon bootup.
  63.  
  64.   o CodeKeys can be disabled or re-enabled at any time.
  65.  
  66.   o A special feature allows HotWire users to automatically load macro
  67.     files for use with specific programs.
  68.  
  69.   o Macros may be named, displayed on screen, and printed for handy
  70.     reference. 
  71.  
  72.   o Resolution-dependent macro definition files can be automatically
  73.     loaded for 6 different resolutions.
  74.  
  75.   o CodeKeys runs in all resolutions, on all STs and the TT.
  76.  
  77.  
  78. How to Install the Demo
  79. -----------------------
  80.  
  81.   CodeKeys consists of two parts, a .PRG which should run from your AUTO
  82. folder at boot time, and a desk accessory which can be installed in the
  83. same way as any other desk accessory (or loaded into MultiDesk).
  84.  
  85.   To start, copy the file called CK_DEMO.PRG to your AUTO folder.  If you
  86. don't have a folder called AUTO on the disk with which you normally boot
  87. up, create one and copy the file called CK_DEMO.PRG into it.  (If you're
  88. unsure about how to create a new folder and copy files into it, please
  89. refer to your Atari Computer Owners' Manual.)  CK_DEMO.PRG is the program
  90. which actually performs the macro recording and playing back.  This
  91. program can be used without the desk accessory editor if memory is tight
  92. (although you lose the ability to edit, save, and load macros without the
  93. accessory).
  94.  
  95.   After placing CK_DEMO.PRG in the AUTO folder, copy the file called
  96. CK_DEMO.ACC to the root (or main) directory of your boot disk.  This
  97. program is the desk accessory editor for macros created with CodeKeys, and
  98. will load as a normal desk accessory if GEM finds it in the root directory
  99. at boot time.  (Make sure you don't have more than 6 .ACC files in the
  100. root directory of your disk -- GEM can only load 6 accessories at a time.)
  101. If you own CodeHead Software's MultiDesk accessory loader/unloader, you
  102. may also load CK_DEMO.ACC into MultiDesk at any time.
  103.  
  104.   OK.  After you've followed the above instructions to the letter, hit
  105. that reset button on the back of your computer and reboot.  The CodeKeys
  106. demo will install; you'll see a message from the AUTO program, then the
  107. desk accessory will actually put up an alert box, and make you press
  108. Return!  (This is just another of my primitive, cave-man techiques to
  109. convince you to buy the real CodeKeys; of course, the real version doesn't
  110. do anything so rude.)
  111.  
  112.   The demonstration version of CodeKeys has some limitations -- there are
  113. only 4 macros available for recording/playback, you can't save and load
  114. macro files, and there is a time limit of 8 minutes and 43 seconds. 
  115.  
  116.  
  117. Recording a Macro
  118. -----------------
  119.  
  120.   You should know first off that CodeKeys can record macros in one of two
  121. different modes -- "timed" or "untimed."  If you want to record mouse
  122. button clicks in a macro, you should record it in "timed" mode so that
  123. the button clicks will keep pace with GEM.  Untimed macros should be used
  124. in circumstances where you're only going to be recording keyboard events,
  125. where timing doesn't matter.
  126.  
  127.   To start recording an "untimed" macro at any time, hold down Alternate,
  128. Left-Shift, and Control and type the Esc key.  At the top line of your
  129. screen you'll see the prompt: "Record macro number:"  The demo of CodeKeys
  130. has four macros available, so type a number from 1 to 4 and hit Return. 
  131. Now the prompt changes to read: "Type trigger key, then macro keys."  The
  132. trigger key is the key (or combination of keys) that will start the
  133. playback of this macro.  Choose a trigger key for the macro (it's best to
  134. use combinations of Shift, Control, and Alternate for trigger keys to
  135. avoid clashes with keys used in programs), then type the keys that will
  136. make up the macro.  When you're finished recording, hold down Alternate,
  137. Left-Shift, and Control and type Esc (again).  You'll hear a little clank
  138. sound to signal the end of a recording.  Now you can open the desk
  139. accessory to edit and view what you just recorded.
  140.  
  141.   To start recording an "timed" macro, hold down Alternate and Control
  142. (notice we omit the Left-Shift key) and type the Esc key.  This time the
  143. prompt at the top of your screen reads: "Timed record - macro number:" 
  144. Again, type a number from 1 to 4 and follow the rest of the directions for
  145. "untimed" macros above.  When recording a timed macro, the exact timing
  146. between all mouse button clicks and key presses is recorded as well as the
  147. clicks and presses themselves.
  148.  
  149.   Note:  regardless of whether you're recording a macro in "timed" or
  150. "untimed" mode, you always end the macro by holding down Alternate,
  151. Left-Shift, and Control and typing the Esc key.
  152.  
  153.  
  154. A Couple of Hints for Recording Mouse Button Macros
  155. ---------------------------------------------------
  156.  
  157.   When recording mouse button presses in a macro, you'll get the best
  158. results if you're very deliberate about your button presses, and hold the
  159. button down a bit longer than you normally might.  If a button press
  160. occasionally fails to register, you can always edit the delay between the
  161. button down and button up events with the CK_DEMO desk accessory.
  162.  
  163.   To create a macro that chooses an item from a drop-down menu, record a
  164. "timed" macro that first clicks with the left button on the drop-down
  165. menu's TITLE (the text that appears on the top line of your screen), then
  166. moves down to the menu selection and clicks on it.  Since CodeKeys records
  167. only button clicks, you need to click on the menu's title to get GEM to
  168. realize that the mouse has been moved into the drop-down area.
  169.  
  170.   When recording double-clicks, you may have to use the editor to shorten
  171. the time between the first click and the second.  Mouse clicks show up in
  172. the editor window as a "button down" event and a "button up" event, with
  173. delay values preceding each.  If it's a "button down" event you'll see an
  174. "L" (Left) or "R" (Right) next to the mouse X and Y coordinates.  If it's
  175. a "button up" event, you'll see the word "UP" next to the coordinates.
  176.  
  177.   By experimentation, we've found that a delay of "1" between the first
  178. and second clicks will reliably produce a double-click that GEM can read.
  179.  
  180.  
  181. Using the Editor
  182. ----------------
  183.  
  184.   The CodeKeys Demo desk accessory lets you edit, rearrange, load and save
  185. (oops, not in the demo version, sorry!), and record macros.  There is an
  186. array of buttons from 1 to 32 in the upper right of the DA's screen. 
  187. Since the demo version only allows 4 macros to be held in memory at one
  188. time, the buttons from 5 to 32 are "grayed-out" and not selectable.  To
  189. select any one of the four available macros, click on its button.
  190.  
  191.   The macro recordings are shown in a window-like area, with scroll bars
  192. that act like a window's.  You can select macro events by clicking on
  193. them; shift-click to select multiple events.  Scrolling the window up or
  194. down does not de-select any events you've selected.  At the top of the
  195. macro window is shown the macro's "trigger" key; underneath that (in
  196. smaller text) is the macro's "title."  Click on the trigger or title to
  197. redefine them.
  198.  
  199.   To edit individual events, click on the event to select it, and click
  200. the button labeled "Replace."  You will be prompted for various types of
  201. responses, depending on the type of event you selected.
  202.  
  203.   Whenever you delete any event or series of events, it is also copied
  204. into a "paste buffer".  To paste the contents of the buffer into another
  205. macro, hold either Shift key while clicking on the Add or Insert buttons. 
  206. Again, you will be prompted according to the circumstances.
  207.  
  208.  
  209. Ordering Information
  210. --------------------
  211.  
  212.   CodeKeys is available NOW for $39.95.  To order the latest version
  213. of CodeKeys or any CodeHead Software product, call us at (213) 386-5735
  214. during business hours (PST).  Our FAX number is (213) 386-5789.  We accept
  215. most major credit cards.
  216.  
  217.   If you don't want to order by phone, you can send a check or money order
  218. for the amount indicated plus $2.00 shipping (Canada $3, Europe $5). 
  219. California residents please add 6.5% sales tax. 
  220.  
  221.   And if your local Atari dealer doesn't have CodeKeys yet, ask him/her to
  222. order it!
  223.  
  224.  
  225.   CodeHead Software
  226.   P.O. Box 74090
  227.   Los Angeles, CA 90004
  228.  
  229.  
  230.   Enjoy the CodeKeys demo!
  231.  
  232. - Charles F. Johnson
  233. - CodeHead Software
  234. - September 21, 1990
  235.